home *** CD-ROM | disk | FTP | other *** search
/ Greenhouse Effect Detection Expriment / NASA Greenhouse Effect Detection Expriment 1992 - Disc 2.iso / document / cdf.doc < prev    next >
Encoding:
Text File  |  1992-03-14  |  9.3 KB  |  216 lines

  1.                         CDF Version 2.2, Pre-Release
  2.  
  3.  
  4. Common Data Format (CDF) is a conceptual data abstraction for storing
  5. multi-dimensional data sets.  The basic component of CDF is a software
  6. programming interface that is a device independent view of the CDF data
  7. model.  The application developer is insulated from the actual physical
  8. file format for reasons of conceptual simplicity, device independence, and
  9. future expandability.  Version 2 of CDF has been rewritten to be portable
  10. across a wide variety of platforms.  CDF files created on any given
  11. platform can be transported to any other platform on to which CDF is ported
  12. and used with any CDF tools or layered applications.  A more detailed
  13. introduction to CDF can be found in the CDF User's Guide.
  14.  
  15. The CDF library and toolkit programs are written in C.  A C compiler (ANSI
  16. standard preferred) is necessary to build the CDF distribution. The CDF
  17. distribution also contains several FORTRAN source files which support the
  18. FORTRAN interface under VMS and Unix.  If a FORTRAN compiler is not
  19. available, contact CDF User Support for the necessary patches. The FORTRAN
  20. interface is not available for MS-DOS in this release.
  21.  
  22. Documentation for CDF consists of the CDF User's Guide.  This document can
  23. be found in the \SOFTWARE\CDF directory of the CD-ROM in an "Adobe"
  24. PostScript file named CDF.PS. It should be printable on any PostScript
  25. printer capable of printing "Adobe" PostScript.  If you have trouble
  26. printing the CDF User's Guide, contact the CDF User Support Office. The
  27. document will be printed so that you can copy it to double-sided and bind
  28. it.
  29.  
  30. Requests for assistance or documentation should be sent to:
  31.  
  32.   Internet -- cdfsupport@nssdca.gsfc.nasa.gov (128.183.36.23)
  33.  
  34. If you get the distribution, please send CDFSUPPORT a message so we can put
  35. you on our mailing list.  That way you will be notified of new releases.
  36.  
  37. UNIX Installation Instructions
  38. ------------------------------
  39.  
  40. CDF V2.2 is distributed for UNIX-based systems as a compressed "tar" file
  41. named cdf22-dist.tar.Z.  Use the "uncompress" command to first uncompress
  42. the tar file.  An example of this is:
  43.  
  44.      uncompress cdf22-dist.tar.Z
  45.  
  46. Then use the "tar" command to extract the CDF library and toolkit source
  47. files from the tar file: "tar" will create a directory named "cdf22-dist"
  48. containing several subdirectories.  The source files for the distribution
  49. will be placed into these directories.
  50.  
  51. The syntax for the "tar" command is different on some flavors of UNIX.  For
  52. Sun/SunOS, DECstation/ULTRIX, SGi/IRIX, and HP9000/HP-UX use:
  53.  
  54.      tar -xvof cdf22-dist.tar
  55.  
  56. For the IBM-RS6000/AIX use:
  57.  
  58.      tar -x -v -f cdf22-dist.tar
  59.  
  60.  
  61. CDF V2.2 has a makefile setup to automatically build the CDF library and
  62. tools.  The following steps should be taken to build and install CDF V2.2.
  63.  
  64.         1. Set your current directory (cd) to the top level CDF directory
  65.            (the directory named "cdf22-dist" created by "tar").
  66.  
  67.         2. This step depends on your machine/operating system.  It will
  68.            compile and link the distribution.
  69.  
  70.              For a Sun/SunOS 4.1 (or newer) installation enter:
  71.  
  72.                 make all.Sun_SunOS
  73.  
  74.  
  75.              For a Sun/SunOS 4.0.3 (or older) installation enter:
  76.  
  77.                 make all.Sun_SunOS_403
  78.  
  79.  
  80.              For a Silicon Graphics/IRIX installation enter:
  81.  
  82.                 make all.SGi_IRIX
  83.  
  84.  
  85.              For a DECstation/ULTRIX installation enter:
  86.  
  87.                 make all.DECstation_ULTRIX
  88.  
  89.  
  90.              For an IBM-RS6000/AIX installation enter:
  91.  
  92.                 make all.IBM-RS6000_AIX
  93.  
  94.              For an HP9000/HP-UX installation enter:
  95.  
  96.                 make all.HP9000_HP-UX
  97.  
  98.  
  99.            Some informational/warning messages may be displayed.  These can
  100.            be ignored and should have no effect on the operation of the
  101.            library or toolkit programs.
  102.  
  103.         3. Test that the distribution was built correctly by entering the
  104.            appropriate command from the following:
  105.  
  106.                 make test.Sun_SunOS
  107.                 make test.Sun_SunOS_403
  108.                 make test.SGi_IRIX
  109.                 make test.DECstation_ULTRIX
  110.                 make test.IBM-RS6000_AIX
  111.                 make test.HP9000_HP-UX
  112.  
  113.            The CDF release, copyright notice, and CDF_OK status message
  114.            should be displayed for each interface tested.
  115.  
  116.         4. Either install the library, include files, and toolkit programs
  117.            in system directories manually or use "make" to automatically
  118.            install them.  Using "make" is dependent on your
  119.            machine/operating system. Enter the appropriate command from the
  120.            following:
  121.  
  122.           make install.Sun_SunOS         INSTALLDIR=<destination-directory>
  123.           make install.Sun_SunOS_403     INSTALLDIR=<destination-directory>
  124.           make install.SGi_IRIX          INSTALLDIR=<destination-directory>
  125.           make install.DECstation_ULTRIX INSTALLDIR=<destination-directory>
  126.           make install.IBM-RS6000_AIX    INSTALLDIR=<destination-directory>
  127.           make install.HP9000_HP-UX      INSTALLDIR=<destination-directory>
  128.  
  129.            The automatic install creates "bin", "include", and "lib"
  130.            directories in the <destination-directory> to install relevant
  131.            files.  <destination-directory> MUST be an absolute path. The
  132.            executables, include files, and library installed in these
  133.            directories should be used by your applications.  If this does
  134.            not fit in with your system directory setup, then you should
  135.            manually install the CDF library, tools, and include files.
  136.  
  137.            For example (assuming a Sun/SunOS 4.1 system) to install from
  138.            the top level CDF directory, the following command will work if
  139.            entered while in that directory (`pwd` is expanded to be the
  140.            absolute path of the current directory).
  141.  
  142.                 make install.Sun_SunOS INSTALLDIR=`pwd`
  143.  
  144.         5. The environment variable CDF_HELP (use the "setenv" command)
  145.            should be set to the location of the "cdf22-dist/help" directory
  146.            (full pathname needed).  This directory contains the online help
  147.            text for the toolkit programs.  The contents of the
  148.            "cdf22-dist/help" directory may be moved provided CDF_HELP is
  149.            set to the new location.
  150.  
  151.         6. This step is optional but may be desirable.
  152.  
  153.            Set up aliases for the toolkit programs.  Suggested aliases and
  154.            their corresponding values follow.
  155.  
  156.                 cdfbrowse        <dir>/bin/cdfbrow
  157.                 cdflist          <dir>/bin/cdflist
  158.                 cdfwalk          <dir>/bin/cdfwalk
  159.                 cdfconvert       <dir>/bin/cdfcvt
  160.                 cdfskeleton      <dir>/bin/skt2cdf
  161.                 skeletontable    <dir>/bin/cdf2skt
  162.                 cdfinquire       <dir>/bin/cdfinq
  163.                 cdfstats         <dir>/bin/cdfstats
  164.                 cdfcompare       <dir>/bin/cdfcmp
  165.                 cdfscope         <dir>/bin/cdfscope
  166.                 cdfdir           <dir>/bin/cdfdir
  167.  
  168.            <dir> is the directory specified in step 4 if the automatic
  169.            install was used.  These aliases can then be used to execute the
  170.            toolkit programs.
  171.  
  172.            An alternative method would be to add <dir>/bin to your PATH
  173.            environment variable.  In this case, you would have to use the
  174.            executable names found in that directory (which in some
  175.            instances would not agree with the names in the documentation).
  176.  
  177.            A file named "definitions.template" exists in the top-level
  178.        directory of the CDF distribution.  It is a template for a script
  179.        file that a user could execute to set up some useful environment
  180.        variables and the aliases just described.  You may want to edit (and
  181.        rename) this template and then have CDF users on your system execute
  182.        it when they want to use CDF.
  183.  
  184.  
  185. MS-DOS Installation Instructions
  186. --------------------------------
  187.  
  188. The MS-DOS version of the distribution system is located on the CD-ROM in
  189. the \SOFTWARE\DOS\CDF22PC subdirectory.  First, you will need to copy
  190. the entire set of directories from the CD-ROM to your hard disk.  Use
  191. the XCOPY command to do this:
  192.  
  193.        XCOPY \SOFTWARE\DOS\CDF22PC C:\CDF22PC /S
  194.  
  195. will copy all the files in all the subdirectories from the current drive
  196. to the subdirectory CDF22PC on drive C:.
  197.  
  198. CDF V2.2 has a batch file set up to automatically build the CDF library and
  199. tools.  The following steps should be taken to build and install CDF V2.2.
  200.  
  201.         1. Set your current directory (cd) to the top level CDF directory
  202.            (the directory named CDF22PC above).
  203.  
  204.         2. This version of CDF requires version 2.0 of the Borland C++
  205.            compiler (it may work with other releases of Borland's C
  206.            compilers but hasn't been tested with them).
  207.  
  208.         3. If you have installed the Borland compiler somewhere other than
  209.            in the subdirectory C:\BORLANDC, you will need to edit
  210.            MAKECDF.BAT to change the directory listed there.  See the
  211.            remarks in the file for specifics on what to change.
  212.  
  213.         4. Enter the command "MAKECDF" at the DOS prompt.  The rest of the
  214.            build should proceed without further intervention.
  215.  
  216.